Release 10.1A: OpenEdge Development:
Progress 4GL Reference

DIALOG-BOX widget

A dialog box is a special type of frame that is displayed in its own window. A dialog box differs from a window in two major respects:

It has a system window ventilator, but has no affordances for minimizing or maximizing.
While a dialog box has input focus, your application cannot perform any other processing until you complete the input or otherwise close the dialog box. That is, it is modal.

You can specify that a frame be displayed as a dialog box by using the VIEW-AS phrase. You can create a dynamic dialog box with the CREATE widget statement.

A dialog box can contain a frame family acting as the root frame. However a dialog box cannot be a child of another frame or dialog box; it can only be parented by a window.

The following dialog box contains:

Two fill-ins
One radio set
One toggle box
Five buttons

Attributes

BACKGROUND attribute1	BGCOLOR attribute2	BORDER-BOTTOM-CHARS attribute1
BORDER-BOTTOM-PIXELS attribute1	BORDER-LEFT-CHARS attribute1	BORDER-LEFT-PIXELS attribute1
BORDER-RIGHT-CHARS attribute1	BORDER-RIGHT-PIXELS attribute1	BORDER-TOP-CHARS attribute1
BORDER-TOP-PIXELS attribute1	BOX-SELECTABLE attribute2	CANCEL-BUTTON attribute
COLUMN attribute	CONTEXT-HELP attribute2	CONTEXT-HELP-FILE attribute2
CURRENT-ITERATION attribute1	DCOLOR attribute3	DEFAULT-BUTTON attribute
DROP-TARGET attribute	DYNAMIC attribute1	FGCOLOR attribute2
FIRST-CHILD attribute1	FONT attribute2	HANDLE attribute1
HEIGHT-CHARS attribute	HEIGHT-PIXELS attribute	HIDDEN attribute
HTML-CHARSET attribute1	LAST-CHILD attribute1	MENU-KEY attribute
MENU-MOUSE attribute3	MOUSE-POINTER attribute	NAME attribute
NEXT-SIBLING attribute1	NUM-DROPPED-FILES attribute1	NUM-SELECTED-WIDGETS attribute1
PARENT attribute	PFCOLOR attribute3	POPUP-MENU attribute
PREV-SIBLING attribute1	PRIVATE-DATA attribute	ROW attribute
SCROLLABLE attribute	SENSITIVE attribute	THREE-D attribute
TITLE attribute	TITLE-BGCOLOR attribute2	TITLE-DCOLOR attribute3
TITLE-FGCOLOR attribute2	TITLE-FONT attribute2	TYPE attribute1
VIRTUAL-HEIGHT-CHARS attribute	VIRTUAL-HEIGHT-PIXELS attribute	VIRTUAL-WIDTH-CHARS attribute
VIRTUAL-WIDTH-PIXELS attribute	VISIBLE attribute	WIDGET-ID attribute 2,4
WIDTH-CHARS attribute	WIDTH-PIXELS attribute	WINDOW attribute1
X attribute	Y attribute
Readable only. Supported in graphical interfaces only. Supported in character interfaces only. Windows only.

Methods

END-FILE-DROP( ) method	GET-DROPPED-FILE( ) method)
GET-SELECTED-WIDGET( ) method	LOAD-MOUSE-POINTER( ) method
VALIDATE( ) method

Events

Developer events	Frame-only direct manipulation events
Universal key function events	DROP-FILE-NOTIFY
ENTRY	LEAVE
WINDOW-CLOSE

Note

Generally, your application must wait to complete dialog box input before continuing with other processing. However, the WAIT-FOR statement for the procedure can also respond to an event for a procedure handle as long as the widget in the WAIT-FOR statement widget list is a procedure handle.

See also

FRAME widget, WAIT-FOR statement, WINDOW widget